home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / pascal / pasuser.com / PASUSERS.PRN < prev   
Encoding:
Text File  |  1989-06-12  |  5.7 KB  |  160 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                   PASUSERS.EXE v1.0
  8.                                          by
  9.                                     Terry Dawson
  10.                                 Compuserve 72665,1505
  11.                                     Opus 1:226/20
  12.  
  13.           What is PASUSERS?
  14.  
  15.           I wrote this program to help me clean up and maintain my Turbo
  16.           Pascal source directory.  It simply provides a sorted list of all
  17.           include files and units that are used by other Pascal source
  18.           modules.  After each file or unit, the source modules that use it
  19.           are given.  Here's a small example of the type of listing
  20.           produced:
  21.  
  22.           PASUSERS v1.0 (c) Copyright 1989 Terry Dawson
  23.  
  24.           ANSIUNIT     used by: LOGSTAT.PAS OOIC.PAS PET.PAS
  25.           ASCIIZ       used by: ASCZDEMO.PAS
  26.           ASYNC4U      used by: ASYNC.PAS X10COM.PAS X10U.PAS
  27.           AUXINOUT     used by: AUXDEMO.PAS TESTAUX.PAS
  28.           BOX          used by: TESTBOX.PAS
  29.           CRSRST.INC   used by: ERRTRP.PAS
  30.           DATEPAK4     used by: LOGMAN.PAS LOGSTAT.PAS OLEVENTS.PAS
  31.                                 OOIC.PAS OTHER1.PAS OTHER2.PAS OTHER3.PAS
  32.           DISPLAY      used by: CIRCULAR.PAS ERROR.PAS
  33.  
  34.           Normally, filenames with no extensions refer to units.  This
  35.           means you should have a .PAS file and/or a .TPU file by that
  36.           name.  PASUSERS does not check for the include, source, or TPU
  37.           file's existence.
  38.  
  39.           The standard units like DOS, CRT and TURBO3 are not included in
  40.           the listing.
  41.  
  42.           How to Use It
  43.  
  44.           PASUSERS is fairly simple to use, but it is also flexible.  If
  45.           you just want to view the list on screen, you can just enter
  46.           "pasusers" at the DOS prompt.
  47.  
  48.           If you want the resulting list sent to a file, you can use DOS
  49.           redirection when you execute it like "pasusers > filename.ext".
  50.           When redirected, the list will not be displayed on the screen,
  51.           but will go to "filename.ext" instead.  DOS devices, like "prn"
  52.           for the printer may be used in place of the filename.
  53.  
  54.           After loading, the program will ask you for a
  55.           "File Mask to Scan:".  This is the filespec, wildcards
  56.           encouraged, for the files you want PASUSERS to scan for "Uses" or
  57.           "{$Include}" statements.  From these files, PASUSERS will build
  58.           the list of files in use.  A full blown list will be generated if
  59.           you use "*.pas" for the mask.  A quick demo may be had by using
  60.           something like "t*.pas".
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.           Paths may also be used for the mask like "\tp\source\*.pas" for
  68.           example.  Additionally, PASUSERS may reside anywhere on your DOS
  69.           path.
  70.  
  71.           If you've been around DOS for a while, the file mask may also be
  72.           given as the first parameter on the command line as in "pasusers
  73.           \tp\source\*.pas > outfile.ext".  The program will not ask you
  74.           for any input at that point.  For batch file use, it will also
  75.           return an errorlevel 1 if no list or a zero length list (in
  76.           redirection) is made.  Errorlevel 0 means it made a list of
  77.           something.
  78.  
  79.           Memory Requirements
  80.  
  81.           The exact memory needed depends on the number of files to be
  82.           processed.  You should always plan to have at least 384k
  83.           available when running PASUSERS.  Each source file is loaded into
  84.           memory for processing and some rather large lists are built for
  85.           parsing.  If you have a very large amount of files and run out of
  86.           memory, give it more memory.
  87.  
  88.           Final Notes
  89.  
  90.           No license is granted herein for inclusion of this program in any
  91.           other program package.  And PASUSERS must not be
  92.           distributed/copied without this documentation.
  93.  
  94.           PASUSERS was written in Turbo Prolog from Borland International.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.                                         - 2 -
  125.  
  126.          ----------------end-of-author's-documentation---------------
  127.  
  128.                         Software Library Information:
  129.  
  130.                    This disk copy provided as a service of
  131.  
  132.                         The Public (Software) Library
  133.  
  134.          We are not the authors of this program, nor are we associated
  135.          with the author in any way other than as a distributor of the
  136.          program in accordance with the author's terms of distribution.
  137.  
  138.          Please direct shareware payments and specific questions about
  139.          this program to the author of the program, whose name appears
  140.          elsewhere in  this documentation. If you have trouble getting
  141.          in touch with the author,  we will do whatever we can to help
  142.          you with your questions. All programs have been tested and do
  143.          run.  To report problems,  please use the form that is in the
  144.          file PROBLEM.DOC on many of our disks or in other written for-
  145.          mat with screen printouts, if possible.  The P(s)L cannot de-
  146.          bug programs over the telephone.
  147.  
  148.          Disks in the P(s)L are updated monthly, so if you did not get
  149.          this disk  directly from the P(s)L,  you should be aware that
  150.          the files in this set may no  longer be the current versions.
  151.  
  152.          For a copy of the latest monthly software library newsletter
  153.          and a list of the 1,800+ disks in the library, call or write
  154.  
  155.                         The Public (Software) Library
  156.                               P.O.Box 35705 - F
  157.                            Houston, TX 77235-5705
  158.                                (713) 665-7017
  159.  
  160.